iap_activate(product_index);
| 参数 | 描述 |
|---|---|
| product_index | 包含可用购买的 ds_list 的索引。 |
返回： N/A（无返回值）
此函数支持应用内购买，并通过提供包含一系列 ds_maps 的产品 ds_list 来准备 GameMaker Studio 2。这意味着你需要告诉 GameMaker Studio 2 所有可用的购买选项，方法是在单独的 ds_maps（每个可用的购买一个）中设置它们，然后将它们存储在 ds_list 中，然后使用这个函数“激活”这些选项。
存储在 ds_list 中的各个购买映射应该具有以下格式键值对：
- "id" - 购买的产品 ID，例如：“LevelPack”。
- "title" - 购买的名称，例如：“Level Pack 1”。
- "description" - 购买说明，例如：“Level Pack 1 for Catch The Clown”。
- "price" - 购买的价格，例如：“$1.00”。
值得注意的是，对于任何目标商店设置（每个产品 ID），唯一必要的键是 “ID”。
激活购买还将触发一个 IAP 事件，创建一个特殊的 iap_data ds_map 的事件类型 iap_ev_product。这个 ds_map 将具有以下附加键:
- "index" - 激活产品的产品 ID。
如果你正在激活多个产品，那么每个产品将触发其类型为 iap_ev_product 的自己的 IAP 事件，然后你可以在其中获得产品 ID。值得注意的是，Google Play store（适用于 Android）一次只能处理 20 个产品的详细信息，对于产品数量较多的应用程序，这可能会导致加载时间较长。
注意：构成购买映射的所有键 / 值对都是字符串！
var purchaseList, purchase1;
purchaseList = ds_list_create();
purchase1 = ds_map_create();
ds_map_add(purchase1, "id", "LevelPack");
ds_map_add(purchase1, "title", "ExtraLevels1");
ds_map_add(purchase1, "description", "Level Pack 1 for Catch The Clown");
ds_map_add(purchase1, "price", "$1.00");
ds_list_add(purchaseList, purchase1);
iap_activate(purchaseList);
ds_map_destroy(purchase1);
ds_list_destroy(purchaseList);
上面的代码将创建一个 ds_list 和一个 ds_map，然后由购买信息填充。此映射已添加到列表中，然后作为游戏的可用购买激活。最后删除 ds_list 和 ds_map 以防止内存泄漏，因为它们不再需要。